home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / devs / baudbandit.doc < prev    next >
Text File  |  1996-07-16  |  12KB  |  260 lines
  1. ---------------------------------------------------------------------------
  2.                                                _________ __          
  3.                                               /___  ___// /           
  4.            CHRISTIAN BUCHNER                     / /   / /            
  5.                                                 / /   / /__   _______
  6.                 PROUDLY PRESENTS               / /   / ___ \ / /__/_/
  7.                                               / /   / /  / // /      
  8.                                              /_/   /_/  /_//_/____   
  9.        ____                      __    ____                       __     __
  10.       / __ \                    / /   / __ \                     / /__  / /
  11.      / /_/ /                   / /   / /_/ /                    / //_/_/ /_
  12.     / _  _/ ____/\ __  __ __  / /   / _  _/ ____/\ /\___   __  / /__ /  __/
  13.    / / \ \ / __/ // / / // _\/ /   / / \ \ / __/ // ___ \ / _\/ // / / /   
  14.   / /__/ // /_/ // /_/ // /_/ /   / /__/ // /_/ // /  / // /_/ // / / /    
  15.  /______//_____//_____//_____/   /______//_____//_/  /_//_____//_/ /_/     
  16.  
  17.  
  18.           THE CHEAPEST WAY TO USE YOUR SERIAL PORT AT LIGHT SPEED
  19.  
  20. ---------------------------------------------------------------------------
  21.    BaudBandit Documentation, Version 1.4c, 22th of November 1992, 18:40
  22. ---------------------------------------------------------------------------
  23.  
  24.  
  25.                          WHAT'S HOT, WHAT'S NEW?
  26.  
  27. This  release  contains  GvpPatch 1.6 which will hopefully fix the problems
  28. with  some  Gvp  Controllers.   The doc file in the archive will inform you
  29. about its exact function and usage.
  30.  
  31. BaudBandit  version 1.4 should fix most problems that occured with previous
  32. versions.   The  nasty  transmission  errors  have  been  fixed, as well as
  33. various other bugs.  Refer to "Version.Doc" for more accurate information.
  34.  
  35. Ah,  I  nearly  forgot  to  mention that you will automagically "receive" a
  36. lovely  text every time BaudBandit is opened.  It will be displayed on your
  37. terminal  screen, but it does not affect BaudBandit's function.  Instead it
  38. will affect the number of registrations, I hope. ;-)
  39.  
  40. The  documentation  has  been  reworked  to clarify some misunderstandings.
  41. Read it again, perhaps you will discover some important details.
  42.  
  43. I have got an EMAIL address now (see below).
  44.  
  45. I also have got a lot of new ideas concerning serial communication (see the
  46. section about future plans).
  47.  
  48.  
  49.                          WHAT IS THE BAUD BANDIT?
  50.  
  51. The BaudBandit is a replacement for the original serial.device allowing you
  52. to  drive  your serial port at baud rates up to 115200 Baud with a standard
  53. 68000 Processor in full multitasking.  Without any doubt the BaudBandit can
  54. be  called  "a little revolution" within the telecommunication scene on the
  55. Commodore Amiga.
  56.  
  57. When  Commodore  developed  the  serial.device some years ago, they were of
  58. course  not able to foresee the development of very cheap modems using data
  59. compression  at incredibly high baud rates like the US Robotics HST and the
  60. new  v32bis  modems.   So  the  serial.device  soon became too slow for the
  61. requirements of modern telecommunication standards.
  62.  
  63. The BaudBandit is especially designed for use with high speed modems and it
  64. supports  full bidirectional RTS/CTS handshake and receive buffering.  This
  65. device will no longer bring your computer to a standstill when transferring
  66. a  file at 14400 baud or more.  Compared to the serial.device, this program
  67. provides a speed increase of about 500% percent.
  68.  
  69.  
  70.                            HOW TO USE THE DEVICE
  71.  
  72. Simply  copy  the BaudBandit.device to your DEVS:  directory.  Now you have
  73. to  configure  your  software  to  the  new device.  Most telecommunication
  74. programs offer a configurable device name and unit.  Here you have to enter
  75. "BaudBandit.device".  The device name is case sensitive, so be sure to type
  76. it right as shown above!
  77.  
  78. The  easiest  way  to install the BaudBandit is to run the program QuickFix
  79. early in your startup sequence.  Then you do not have to change any of your
  80. configurations.   QuickFix  will patch the OpenDevice() vectors so that any
  81. attempt  to open the serial device will open the BaudBandit device instead.
  82. The  patch  may  be  removed at any time with a CTRL-C or the break command
  83. from an AmigaShell.
  84.  
  85. If  you use an A2232 multiserial card, you may install the program A2232Fix
  86. in  your  startup  sequence.  Do NOT run QuickFix in this case.  When using
  87. A2232Fix,  you do not need to change any of your configurations.  The patch
  88. will  replace  oldser.device  with the faster BaudBandit.device by patching
  89. the  OpenDevice()  vectors.   This allows you to access the internal serial
  90. port  via  A2232's serial.device, but this time using my faster BaudBandit.
  91. Please note that the BaudBandit will NOT speed up the A2232 ports.
  92.  
  93.  
  94.                        WHAT ABOUT THE COMPATIBILITY?
  95.  
  96. The  code  is designed to work under OS1.2/1.3 as well as OS2.0.  It should
  97. run on all processors from 68000 to 68040.
  98.  
  99. In  order  to  get  the  best speed results, I dropped some features of the
  100. original serial.device which are usually not needed in telecommunication.
  101.  
  102. I  completely  dropped  the  xOn/xOff protocoll, as well as the termination
  103. array  and  parity  checks.   Breaks are currently not supported but may be
  104. included in later versions.  Characters must consist of 8 bits.  The device
  105. only supports plain 8N1 RTS/CTS transfer.  But this is all you need!
  106.  
  107. The  BaudBandit.device  should be able to replace the serial.device in most
  108. situations.   It  has  been  tested  with  Fido  mailers  like TrapDoor and
  109. terminal  programs like Term, NComm and Magicall.  Up- and downloads are no
  110. problem  and especially at high speed transfers you should notice that your
  111. computer  will NOT stand still anymore.  FAXing is possible, too.  This has
  112. been tested with GPFax and other software.
  113.  
  114.  
  115.                            HARDWARE REQUIREMENTS
  116.  
  117. The  device  supports  a very common handshake method for high speed modems
  118. using  the  RTS/CTS  wires.  The RTS/CTS wires prevent a buffer overflow on
  119. the  computer  and  on  the  modem  side.   This  handshake method is often
  120. referred to as "flow control".
  121.  
  122. THIS  IS  IMPORTANT:  In order for the device to work properly, you have to
  123. connect  these  wires to your computer, even if your modem does not support
  124. this  handshake method.  Without the RTS/CTS wires connected to your serial
  125. port, the device will not be able to send anything!
  126.  
  127.  
  128.                      WHAT IS INCLUDED IN THIS PACKAGE?
  129.  
  130. This  archive  contains  an  fully  functional  version of the device and a
  131. complete  documentation.  The device displays a little text on the terminal
  132. screen  reminding you that it is shareware.  If you want to use the program
  133. regularly,  you  have  to  register. 
  134.  
  135. Please  note  that  the  contents  of  the  distribution archive may not be
  136. altered in any way.  Any modification of the program is prohibitted.
  137.  
  138.  
  139.                            WHY IS IT SHAREWARE?
  140.  
  141. The  development  of  this  programm  has taken many weeks of hard work and
  142. frustration.   Previous  versions  of  BaudBandit were not as reliable as I
  143. wanted  them  to  be,  but  now  I  hope  to  present  a reliable and fully
  144. functional program which will be of great use for many people.
  145.  
  146. Please understand that I do not want to give this program away for free.  I
  147. ask  you  to pay a small shareware donation.  The more people register, the
  148. more  support  this  product  will  get.  The shareware fee will help me to
  149. support my customers and to continue my work on this project.
  150.  
  151.  
  152.                               HOW TO REGISTER
  153.  
  154. Before  you decide to register, please check whether this program satisfies
  155. all your requirements or not.  You are allowed to evaluate this program for
  156. two weeks.  If you continue using it, you have to register.
  157.  
  158. Fill  in the registration form and send it to me.  I think, it is justified
  159. to ask for a shareware donation of DM 20.  This is very cheap for a project
  160. like  BaudBandit  and  it is not even half the price the authors demand for
  161. programs like TrapDoor or Foozle.  There are many ways of sending the money
  162. to me, so don't tell me that you did not know how to do it.
  163.  
  164. a) Enclose it cash.
  165. b) Send me a cheque over DM 20.
  166. c) Let your bank transfer it to me
  167. d) Transfer it with a postal money order.
  168.  
  169. Please do not transfer any money before having sent the registration form!
  170.  
  171. The registration form must be mailed to the following address:
  172.  
  173.                          Christian Buchner
  174.                          Ganghoferstraße 2
  175.                          8034 Germering
  176.                          Deutschland
  177.  
  178. You may transfer the money to the following account:
  179.  
  180.                          Raiffeisenbank Germering-Olching
  181.                          Bankleitzahl 701 693 80
  182.                          Kontonummer  49573
  183.  
  184. After  registering,  you  will  receive  a  BaudBandit version that does no
  185. longer  display  the reminder text.  Important updates and bugfixes will be
  186. sent  to you as long as the mailing costs do not exceed a reasonable level.
  187. I  prefer  sending  the device UUEncoded via Netmail.  The device itself is
  188. about  4KB  in length, so this should be no problem.  If it is not possible
  189. to  reach  you  on the digital way, I'll use the analog method and send you
  190. the device on a disk.
  191.  
  192.  
  193.                                FUTURE PLANS
  194.  
  195. Depending  on  your  needs  and  wishes, I will eventually add XOn/XOff and
  196. Break  support to the BaudBandit device.  Write to me if you need these new
  197. features.
  198.  
  199. Please  do  not  "forget" to register to BaudBandit.  Since there is such a
  200. sad  discrepancy  between  the  number  of REGISTERED USERS compared to the
  201. number  of  ILLEGAL  USERS,  I  am  honestly  thinking  of programming some
  202. shareware requesters and a rigorous time limit for the next updates as well
  203. as  for  any  future projects.  This method worked with MFR and I'm sure it
  204. works for BaudBandit as well.  It's up to you.
  205.  
  206. I  am  planning to create a program, that will patch itself in front of any
  207. serial device to provide data compression and error correction.  It will be
  208. implemented  as  an  OS2.0  style  commodity and it will use the XPK packer
  209. standard  allowing  you  to select any compression and/or encryption method
  210. that  is  currently  available  as  XPK  external  library.   This might be
  211. especially  useful  for  all those people who have not yet deciced to buy a
  212. faster modem.  A very complex project, but I love the idea.
  213.  
  214. Another  nice  idea  is  to create a xpr library that allows realtime voice
  215. chats  via  high speed modem using your sound sampler in the parallel port.
  216. The  implementation  as an xpr external library allows usage in ANY mailbox
  217. and  terminal  program!   The  sound  data  will  be  reduced to 4 bit thus
  218. doubling  the  sampling  rate.   This would be just a toy, but a very funny
  219. one.   Eventually,  it  will be possible to arrange digital conferences, if
  220. the host system has enough CPU power. ;-)
  221.  
  222. How  about  a  pipe-style  serial  device  that allows you to test your bbs
  223. system  locally?   All  data  sent  to unit 0 comes out at unit 1, and vice
  224. versa.  What do you think of it?
  225.  
  226.  
  227.                              IF YOU FIND A BUG
  228.  
  229. If  you  discover  a  bug  or  a  problem,  please  inform me as quickly as
  230. possible.  It is important for me to get very accurate information.  Please
  231. tell  me  excactly  in what situation, with what software and configuration
  232. the  problem  aroused.   Bugs are easier to spot if they are reproduceable.
  233.  
  234.  
  235.                              HOW TO CONTACT ME
  236.  
  237. If  you have any questions concerning this device or anything else, you can
  238. reach  me  via Fidonet and via InterNet.  Just write a netmail to Christian
  239. Buchner  at node 2:246/65 or send your mail to cbuchner@heavenly.lm.sub.org
  240. Please be careful.  Your mails might get lost on their way.
  241.  
  242. Send love letters and registrations to the following address:
  243.  
  244.                              Christian Buchner
  245.                              Ganghoferstraße 2
  246.                               8034 Germering
  247.                                 Deutschland
  248.  
  249.  
  250.  
  251.            ----------------------------------------------------
  252.            And always remember: USING it means PAYING it, okay?
  253.            ----------------------------------------------------
  254.  
  255.                 I can not FORCE you, but I may PLEASE you.
  256.  
  257.  
  258.  
  259.                                (End of File)
  260.